home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / bgnsur.z / bgnsur
Encoding:
Text File  |  2002-10-03  |  4.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. bbbbggggnnnnssssuuuurrrr((((3333GGGG))))                                                          bbbbggggnnnnssssuuuurrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      bbbbggggnnnnssssuuuurrrr,,,, eeeennnnddddssssuuuurrrr - delimit a NURBS surface definition
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee bbbbggggnnnnssssuuuurrrr
  13.  
  14.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee eeeennnnddddssssuuuurrrr
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _n_o_n_e
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      Use bbbbggggnnnnssssuuuurrrr to mark the beginning of a NURBS (Non-Uniform Rational B-
  21.      Spline) surface definition. After you call bbbbggggnnnnssssuuuurrrr, call the routines that
  22.      define the surface and that provide the trimming information.  To mark
  23.      the end of a NURBS surface definition, call eeeennnnddddssssuuuurrrr.
  24.  
  25.      Within a NURBS surface definition (between bbbbggggnnnnssssuuuurrrr and eeeennnnddddssssuuuurrrr), you may
  26.      use only the following Graphics Library subroutines:  nnnnuuuurrrrbbbbssssssss,,,, bbbbggggnnnnttttrrrriiii,,,,
  27.      eeeennnnddddttttrrrriiii,,,, nnnnuuuurrrrbbbbsssscccc,,,, and ppppwwwwllllccccuuuurrrr.  The NURBS surface definition must consist of
  28.      exactly one call to nnnnuuuurrrrbbbbssssssss to define the shape of the surface.  In
  29.      addition, this call may be preceeded by calls to nnnnuuuurrrrbbbbssssssss that specify how
  30.      texture and color parameters vary across the surface.  The call(s) to
  31.      nnnnuuuurrrrbbbbssssssss may be followed by a list of one or more trimming loop definitions
  32.      (to define the boundaries of the surface).  Each trimming loop definition
  33.      consists of one call to bbbbggggnnnnttttrrrriiii, one or more calls to either ppppwwwwllllccccuuuurrrr or
  34.      nnnnuuuurrrrbbbbsssscccc, and one call to eeeennnnddddttttrrrriiii....
  35.  
  36.      The system renders a NURBS surface as a polygonal mesh, and calculates
  37.      normal vectors at the corners of the polygons within the mesh. Therefore,
  38.      your program should specify a lighting model if it uses NURBS surfaces.
  39.      If your program uses no lighting model, all the interesting surface
  40.      information is lost.  When using a lighting model, use llllmmmmddddeeeeffff and llllmmmmbbbbiiiinnnndddd
  41.      to define or modify materials and their properties.
  42.  
  43. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  44.      The following code fragment draws a NURBS surface trimmed by two closed
  45.      loops.  The first closed loop is a single piecewise linear curve (see
  46.      ppppwwwwllllccccuuuurrrr), and the second closed loop consists of two NURBS curves (see
  47.      nnnnuuuurrrrbbbbsssscccc), joined end to end:
  48.  
  49.           call bgnsur
  50.               call nurbss(. . .)
  51.               call bgntri
  52.                   call pwlcur(. . .)
  53.               call endtri
  54.               call bgntri
  55.                   call nurbsc(. . .)
  56.                   call nurbsc(. . .)
  57.               call endtri
  58.           call endsur
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. bbbbggggnnnnssssuuuurrrr((((3333GGGG))))                                                          bbbbggggnnnnssssuuuurrrr((((3333GGGG))))
  71.  
  72.  
  73.  
  74. NNNNOOOOTTTTEEEE
  75.      On Impact and Infinite Reality llllmmmmccccoooolllloooo cannot be called between bbbbggggnnnnssssuuuurrrr and
  76.      eeeennnnddddssssuuuurrrr
  77.  
  78.  
  79. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  80.      nurbss, bgntri, nurbsc, pwlcur, setnur, getnur
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.